Document that GtkApplication loads gtk/menus-common.ui
authorPhillip Wood <phillip.wood@dunelm.org.uk>
Wed, 17 Feb 2016 10:10:25 +0000 (10:10 +0000)
committerPhillip Wood <phillip.wood@dunelm.org.uk>
Thu, 18 Feb 2016 14:11:14 +0000 (14:11 +0000)
Add a comment about the resource gtk/menus-common.ui to the
documentation of the other resources loaded by GtkApplication.

https://bugzilla.gnome.org/show_bug.cgi?id=761432

gtk/gtkapplication.c

index ce023a21abd4d58611877f33c5ac7d9129a7c2d9..9ecd969be6ccfb09f4c7a87c8c84718564131e37 100644 (file)
  * dynamic population of a part of the menu structure.
  *
  * If the resources "gtk/menus-appmenu.ui" or "gtk/menus-traditional.ui" are
- * present then these files will be used in preference, depending on the
- * value of gtk_application_prefers_app_menu().
+ * present then these files will be used in preference, depending on the value
+ * of gtk_application_prefers_app_menu(). If the resource "gtk/menus-common.ui"
+ * is present it will be loaded as well. This is useful for storing items that
+ * are referenced from both "gtk/menus-appmenu.ui" and
+ * "gtk/menus-traditional.ui".
  *
  * It is also possible to provide the menus manually using
  * gtk_application_set_app_menu() and gtk_application_set_menubar().